* > In GTK+ 3.0, resource files have been deprecated and replaced by
* > CSS-like style sheets, which are understood by #GtkCssProvider.
*
- * # Default files #
+ * # Default Files #
*
* An application can cause GTK+ to parse a specific RC
* file by calling gtk_rc_parse(). In addition to this,
* Additionally, the `GTK2_RC_FILES` environment variable
* can be set to a #G_SEARCHPATH_SEPARATOR_S-separated list of files
* in order to overwrite the set of default files at runtime.
-
- * <anchor id="locale-specific-rc"/>
+ *
+ * # Locale Specific Files # {#locale-specific-rc}
+ *
* For each RC file, in addition to the file itself, GTK+ will look for
* a locale-specific file that will be parsed after the main file.
* For instance, if `LANG` is set to `ja_JP.ujis`,
* for `~/.gtkrc.ja_JP` and `~/.gtkrc.ja`,
* and parses the first of those that exists.
*
- * # Pathnames and patterns #
+ * # Pathnames and Patterns #
*
* A resource file defines a number of styles and key bindings and
* attaches them to particular widgets. The attachment is done
* up, and `gtk` is used for styles
* that GTK+ creates internally.
*
- * # Theme gtkrc files #
+ * # Theme gtkrc Files #
*
* Theme RC files are loaded first from under the `~/.themes/`,
* then from the directory from gtk_rc_get_theme_dir(). The files looked at will
* as possible, because matching `"A*B*C*RestString"` can
* result in matching complexities of O(n^2) worst case.
*
- * # Toplevel declarations #
+ * # Toplevel Declarations #
*
* An RC file is a text file which is composed of a sequence
* of declarations. `“#”` characters delimit comments and
* A color used for the background of widgets that have
* been set insensitive with gtk_widget_set_sensitive().
*
- * <anchor id="color-format"/>
+ * ## Color Format ## {#color-format}
+ *
* Colors can be specified as a string containing a color name (GTK+ knows
* all names from the X color database `/usr/lib/X11/rgb.txt`),
* in one of the hexadecimal forms `#rrrrggggbbbb`,
* @n_args: number of arguments specified for the signal
* @args: the arguments specified for the signal
*
- * <anchor id="keybinding-signals"/>
* A GtkBindingSignal stores the necessary information to
* activate a widget in response to a key press via a signal
* emission.
* @scroll_type: a #GtkScrollType
*
* The ::move-active signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to move the active selection.
*
* Since: 2.12
* @widget: the object that received the signal
*
* The ::popup signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to popup the combo box list.
*
* The default binding for this signal is Alt+Down.
* @button: the object which received the signal
*
* The ::popdown signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to popdown the combo box list.
*
* The default bindings for this signal are Alt+Up and Escape.
* GtkDialog::close:
*
* The ::close signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user uses a keybinding to close
* the dialog.
*
* the Enter key.
*
* While this signal is used as a
- * [keybinding signal][keybinding-signals],
+ * [keybinding signal][GtkBindingSignal],
* it is also commonly used by applications to intercept
* activation of entries.
*
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @entry, this signal causes
* the viewport to be moved instead.
* @string: the string to insert
*
* The ::insert-at-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates the insertion of a
* fixed string at the cursor.
*
* @count: the number of @type units to delete
*
* The ::delete-from-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a text deletion.
*
* If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection
* @entry: the object which received the signal
*
* The ::backspace signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* The default bindings for this signal are
* @entry: the object which received the signal
*
* The ::cut-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to cut the selection to the clipboard.
*
* The default bindings for this signal are
* @entry: the object which received the signal
*
* The ::copy-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to copy the selection to the clipboard.
*
* The default bindings for this signal are
* @entry: the object which received the signal
*
* The ::paste-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to paste the contents of the clipboard
* into the text view.
*
* @entry: the object which received the signal
*
* The ::toggle-overwrite signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to toggle the overwrite mode of the entry.
*
* The default bindings for this signal is Insert.
* name.
*
* The ::location-popup signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show a "Location"
* @widget: the object which received the signal.
*
* The ::location-popup-on-paste signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show a "Location"
* @widget: the object which received the signal.
*
* The ::location-toggle-popup signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to toggle the visibility of a "Location"
* @widget: the object which received the signal.
*
* The ::up-folder signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser go to the parent of
* @widget: the object which received the signal.
*
* The ::down-folder signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser go to a child of the
* @widget: the object which received the signal.
*
* The ::home-folder signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the user's home
* @widget: the object which received the signal.
*
* The ::desktop-folder signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the user's Desktop
* @bookmark_index: the number of the bookmark to switch to
*
* The ::quick-bookmark signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser switch to the bookmark
* @widget: the object which received the signal.
*
* The ::show-hidden signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser display hidden files.
* @widget: the object which received the signal.
*
* The ::search-shortcut signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the search entry.
* @widget: the object which received the signal.
*
* The ::recent-shortcut signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* This is used to make the file chooser show the Recent location.
* double-clicking, or by using the Space or Enter key.
*
* While this signal is used as a
- * [keybinding signal][keybinding-signals],
+ * [keybinding signal][GtkBindingSignal],
* it can be used by applications for their own purposes.
*/
child_signals[CHILD_ACTIVATE] =
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::activate-cursor-child signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user activates the @box.
*/
signals[ACTIVATE_CURSOR_CHILD] = g_signal_new ("activate-cursor-child",
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::toggle-cursor-child signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which toggles the selection of the child that has the focus.
*
* The default binding for this signal is Ctrl-Space.
* @count: the number of @step units to move
*
* The ::move-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @text_view, this signal causes
* the viewport to be moved instead.
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::select-all signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to select all children of the box, if
* the selection mode permits it.
*
* @box: the #GtkFlowBox on which the signal is emitted
*
* The ::unselect-all signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to unselect all children of the box, if
* the selection mode permits it.
*
* GtkIconView::select-all:
* @iconview: the object on which the signal is emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user selects all items.
*
* Applications should not connect to it, but may emit it with
* GtkIconView::unselect-all:
* @iconview: the object on which the signal is emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user unselects all items.
*
* Applications should not connect to it, but may emit it with
* GtkIconView::select-cursor-item:
* @iconview: the object on which the signal is emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user selects the item that is currently
* focused.
*
* GtkIconView::toggle-cursor-item:
* @iconview: the object on which the signal is emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user toggles whether the currently
* focused item is selected or not. The exact effect of this
* depend on the selection mode.
* GtkIconView::activate-cursor-item:
* @iconview: the object on which the signal is emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user activates the currently
* focused item.
*
* @count: the number of @step units to move
*
* The ::move-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a cursor movement.
*
* Applications should not connect to it, but may emit it with
* GtkInfoBar::close:
*
* The ::close signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user uses a keybinding to dismiss
* the info bar.
*
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @entry, this signal causes
* the viewport to be moved instead.
* @label: the object which received the signal
*
* The ::copy-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to copy the selection to the clipboard.
*
* The default binding for this signal is Ctrl-c.
* GtkLabel::activate-current-link:
* @label: The label on which the signal was emitted
*
- * A [keybinding signal][keybinding-signals]
+ * A [keybinding signal][GtkBindingSignal]
* which gets emitted when the user activates a link in the label.
*
* Applications may also emit the signal with g_signal_emit_by_name()
* @reversed: whether cycling backward or forward
*
* The ::cycle-child-focus signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to cycle the focus between the children of the paned.
*
* The default binding is f6.
* @widget: the object that received the signal
*
* The ::toggle-handle-focus is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to accept the current position of the handle and then
* move focus to the next widget in the focus chain.
*
* @scroll_type: a #GtkScrollType
*
* The ::move-handle signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to move the handle when the user is using key bindings
* to move it.
*
* @reversed: whether cycling backward or forward
*
* The ::cycle-handle-focus signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to cycle whether the paned should grab focus to allow
* the user to change position of the handle by using key bindings.
*
* @widget: the object that received the signal
*
* The ::accept-position signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to accept the current position of the handle when
* moving it using key bindings.
*
* @widget: the object that received the signal
*
* The ::cancel-position signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to cancel moving the position of the handle using key
* bindings. The position of the handle will be reset to the value prior to
* moving it.
* @button: the object which received the signal
*
* The ::popup signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to popup the scale widget.
*
* The default bindings for this signal are Space, Enter and Return.
* @button: the object which received the signal
*
* The ::popdown signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to popdown the scale widget.
*
* The default binding for this signal is Escape.
* horizontally or not
*
* The ::scroll-child signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when a keybinding that scrolls is pressed.
* The horizontal or vertical adjustment is updated which triggers a
* signal that the scrolled windows child may listen to and scroll itself.
* %GTK_DIR_TAB_BACKWARD
*
* The ::move-focus-out signal is a
- * [keybinding signal][keybinding-signals] which gets
+ * [keybinding signal][GtkBindingSignal] which gets
* emitted when focus is moved away from the scrolled window by a
* keybinding. The #GtkWidget::move-focus signal is emitted with
* @direction_type on this scrolled windows toplevel parent in the
* @extend_selection: %TRUE if the move should extend the selection
*
* The ::move-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a cursor movement.
* If the cursor is not visible in @text_view, this signal causes
* the viewport to be moved instead.
* @count: the number of @step units to move
*
* The ::move-viewport signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which can be bound to key combinations to allow the user
* to move the viewport, i.e. change what part of the text view
* is visible in a containing scrolled window.
* @text_view: the object which received the signal
*
* The ::set-anchor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates setting the "anchor"
* mark. The "anchor" mark gets placed at the same position as the
* "insert" mark.
* @string: the string to insert
*
* The ::insert-at-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates the insertion of a
* fixed string at the cursor.
*
* @count: the number of @type units to delete
*
* The ::delete-from-cursor signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user initiates a text deletion.
*
* If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection
* @text_view: the object which received the signal
*
* The ::backspace signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user asks for it.
*
* The default bindings for this signal are
* @text_view: the object which received the signal
*
* The ::cut-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to cut the selection to the clipboard.
*
* The default bindings for this signal are
* @text_view: the object which received the signal
*
* The ::copy-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to copy the selection to the clipboard.
*
* The default bindings for this signal are
* @text_view: the object which received the signal
*
* The ::paste-clipboard signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to paste the contents of the clipboard
* into the text view.
*
* @text_view: the object which received the signal
*
* The ::toggle-overwrite signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to toggle the overwrite mode of the text view.
*
* The default bindings for this signal is Insert.
* @select: %TRUE to select, %FALSE to unselect
*
* The ::select-all signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to select or unselect the complete
* contents of the text view.
*
* @text_view: the object which received the signal
*
* The ::toggle-cursor-visible signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted to toggle the visibility of the cursor.
*
* The default binding for this signal is F7.
* @window: the window which received the signal
*
* The ::activate-focus signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user activates the currently
* focused widget of @window.
*/
* @window: the window which received the signal
*
* The ::activate-default signal is a
- * [keybinding signal][keybinding-signals]
+ * [keybinding signal][GtkBindingSignal]
* which gets emitted when the user activates the default widget
* of @window.
*/
projects / gtk4.git / commitdiff